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PREFACE 


The Agriculture and Resources Inventory Surveys Through Aerospace Remote 
Sensing Is a 6-year program of research, development, evaluation, and application 
of aerospace remote sensing for agricultural resources, which began In fiscal 
year 1980. This program Is a cooperative effort of the National Aeronautics 
and Space Administration, the U.S. Agency for International Development, and 
the U.S. Departments of Agriculture, Commerce, and the Interior. 

The work which Is the subject of this document was performed within the Earth 
Resources (Research / Applications) Division, Space and Life Sciences Directorate, 
at the Lyndon B. Johnson Space Center, National Aeronautics and Space Adnlnls- 
tratlon. Under Contract NAS 9-15800, personnel of Lockheed Engineering and 
Management Services Company, Inc., performed the tasks which contributed to 
the completion of this research. 
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1. GENERAL INFORMATION 


1.1 SYSTEM NAME 

This system is called Wheat Stress Indicator Model CCAO Data Base Interface 
Driver, 

1.2 PRIMARY USER 

The U.S. Department of Agriculture (USDA), Foreign Agriculture Service, Crop 
Condition Assessment Division (CCAD) personnel are the primary users of the 
system. 

1.3 DEVELOPING ORGANIZATION 

Personnel of the Lockheed Engineering and Management Services Company, Inc., 
developed the software that is reported in this document. 

1.4 COMPUTER FACILITY DESCRIPTION 

The Wheat Stress Indicator Model CCAD Data Base Interface Driver routine runs 
on a Programmed Data Processor, Model 11/70 (POP 11/70) computer, with an 
Interactive Applications System (IAS) operating system and a Data Base Manage 
ment System 11 (DBMS 11). It is implemented at the USDA Foreign Agricultural 
Service (FAS) in Houston, Texas. 

1.5 REFERENCES 

Data used for this manual were obtained from Wheat Stress Indicator Model 
documentation, at the CCAD Software Documentation Library, USDA FAS, Houston, 
Texas 77058. 


2. SYSTEM DESCRIPTION 

2.1 PURPOSE 

The purpose of the system is to interface the Wheat Stress Indicator Model with 
the CCAO operational data base. The interface driver routine decides what 
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nwteorological stations should be processed and calls the proper subroutines to 
process the stations. 

2.2 USAGE 

The system resides on the User Interface System (UlS) processor and must be 
executed on that processor. The POS command Is as follows. 

POS > RUN WHAZRO CR 

The program will then be prepared for Input from the terminal and will Issue 
the statement: 

INPUT 3 CHARACTER CROP CODE 

XXX CR 

INPUT RUN DEFINITION CARO. INPUT 0 TO STOP. 

The run definition^ card Is defined In figure 1. To end the run, a 'O' (zero) 
must be Input as an Input card type. 


3. INPUT 

The model requires two types of Input; disk and card, which are described as 
follows. 

3.1 DISK 

The model Interfaces with the CCAD data base using the METS2P subschema. The 
formats used for the data and the methods of access are available from the CCAD 
Data Base administrator. 

3.2 CARD 

To run the model, two types of Input cards are required, a crop ctrd and a run 
definition card. The formats of the run definition cards are shown In 
figure 1. The format of the crop card Is shown In figure 2. 
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Hitrarchy ID 


Stop 4ay 


Start Stop 
latitudt latltuda 



Hitrarchy ID: Country only • Procttt all stations In country. 

Country and rtplon only • Procass all stations In ration. 

Country, ration, and tona • Procass all stations In zona. 

Country, raplon, zona, and strata • Procass all stations in strata. 

Stop day: Blanks - Usa all nataorolodlcal data. 

Data • Usa niataoro1n<;ical data prior to data. 

Start'Stop latltudas: Blanks - Procass all stations batwaan 30* and 60*. 

Latitudas - Procass stations batMan Input latltudas. 


(a) Ca>*d and rulas Mhara coda ■ I 


Mataorological station ID Stop day 



Mataorological station ID: 
Stop day: 


Station ID • Procass only this station. 

Blanks • Procass all nataorologlcal data. 

Data • Procass mataorological data prior to data. 


(b) Card and rulas whara ccwa • 2 


Figure 1.- Run definition card formats for the Wheat Stress Indicator Model. 
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The first card of the deck must be a crop card In the foil owl 09 format. 



Figure 2.- Crop card format. 


4. PROCESSING 


4.1 INTERACTIVE 

The model Is designed to be operated In an Interactive mode. All error 
messages are displayed on the cathode ray tube (CRT) terminal on which the run 
was Initiated and will be displayed during execution. The output reports are 
written In files that are sent to the line printer Immediately after the 
completion of the model run. The procedure for running the model Is presented 
In paragraph 2.2. 

4.2 BATCH 

The model Is not presently configured to run In a batch environment. A simple 
modification to the driver routine and task builder command file would be 
required In order to provide a batch capability. 

4.3 EXECUTION FLOW 

A flow chart of the model Is provided In figure 3. 

5. OUTPUT 

Two types of output are provided from the model; disk and hard copy. They are 
described as follows. 

5.1 DISK 

For each day of meteorological data, the model creates a STN-PROOUCTS record 
for the day and stores It In the CCAD data base. The record contains the 
results of the model run for that day. The format for the STN-PRODUCTS record 
Is available from the CCAD Data Base administrator. 
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Figure 3.- Execution flow diagrair. 
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5.2 HARDCOPY 


Output from a model run provides at many as four possible reports* If the crop 
calendar runs, then the file 'CLOCK. OAT* will be printed; If the soil moisture 
budget runs, then the file 'S01LM.DAT' will be printed; and If both run, then 
the additional files 'HAZARO.DAT' and 'HAZSUM.OAT' will be printed. The 
content of each file Is as follows. 

A. 'CLOCK. OAT': For each day for which data are processed, a record Is kept 

containing the station Identification (ID), date (both Julian and 
calendar), clock acceleratlon/deceleratlon factor (FMULT), planting day 
(Julian day/year), dally crop calendar Increment (ACC), and cumulative crop 
calendar (STAGE). 

B. 'S0ILH.DAT': For each day for which data are processed, a record Is kept 
containing the station ID, total precipitation (P), mean temperature (T), 
potential evapotranspi ration (PE), topsoil moisture (SS), subsoil moisture 
(SU), available water capacity (AWC), computed evapotranspi ration (ET), 
computed recharge moisture (R), computed runoff (RO), and date (Julian and 
calendar). 

C. 'HAZARD.DAT'-: A dally record Is kept Indicating each stress condition. 

The records show the station ID, the clock (stage of crop development), 
calendar dote, and a textual message stating the specific stress 
condition. A list of stress conditions and their corresponding data base 
flags Is Included In table 1. 

D. 'HAZSUM.DAT': For each station, a summary Is provided showing the total 

number of growing days, optimal days, and hazard (stress) days with respect 
to the stage of crop development. 

6. SPECIAL IKSTRUCTIONS OR RESTRICTIONS 

The Wheat Stress Indicator Model requires several Inputs to run. The following 
rules have been Implemented In the driver program. 
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TABLE 1 


St< 9 t $t«qt dttcriptlon 

Prtpipntinq Up to 10 d«ys Oofort 
plpntlnq 

Prtpipnting «nd From 10 day« bdfort pUntIng 
PottpUntIng to 12 d«yt afttr planting 

PrttMtrgtnct 0 < Stag# <1.0 

Emtrgtnce 1 < Stag* < 1.2 

Tllltring i Stag* < 2.0 

Jointing 2.0 < Stage < 3.0 

Heading 3.0 < Stage < 3.6 

Soft dough 36 < Stage <4.0 


Ripening 


4.0 < Stage < 4.5 


HAZARD MATRIX 


Hag 

Strtss condition 

A1 

Surface >*o1tture < .12 In. 
(poor aaeedlng inoitture) 

A2 

Stirface Moisture > .8 In. 
or precipitation > .2 In. 
(tractabIHty prob1en«p1 anting delay 

81 

Surface •tolsture < .12 In. 
(poor gemination possible) 

R2 

Mlnlinun ttmptnturo < 37* F 
(poor otnnlfiitlon ootslblt) 

Cl 

Surfict (nol Sturt < .12 In. 

C2 

Hlnlmuw tfinotraturt < 19* F 
(svvtrt frost di«naot possible) 

01 

Subsurface nolsture < 25% of a capacity (AUC) 

02 

Mlnlfiiufii temperature < 19* F 
(severe frost damaqe possible) 

El 

Subsurface mol sure < A0% of capacity (AUC) 

E2 

Hlnlmum temperature < 19* F 
(severe frost damage possible 

FI 

Subsurface moisture < 40% of capacity < (AWC) 

F2 

Minimum temperature < 32* F 
(frost damage possible) 

F3 

Maximum temperature > 107* F 
(sterilization possible) 

G1 

Subsurface moisture < 25% of capacity (AwC) 

G2 

Minimum temperature < 32* F 
(frost damage possible) 

G3 

Maximum temperature > 107* F 
1 (sterilization possible) 

HI 

Subsurface Moisture < 10% of capacity (AwC) 

H2 

Minimum teniperature < 19* F 
(severe frost damage possible) 







a. If any of the following data items are missing frw the crop-station record 
( STN-PROOUCTS record), the soil moisture portion of the model will not 
process that station. 

COEFF1-COF0 (CONB) 

C0EFF2-C0FI (CONI) 

COEFF3-FMULT (FF.ULT) 

WHC-S-COMPOSITE (AWC) 

b. If the planting date (DATE-PLANTING) is missing from the crop-station 
record, the crop calendar portion of the model will not process that 
station. 

c. At least one STN-PROOUCTS record per station must be stored in the data 
base to initialize the model for the run. If the STN-PROOUCTS record for a 
station is missing, the station will not be processed. 

d. If any of the following data items are missing from the STN-PROOUCTS 
record, the soil moisture portion of the model will not process that 
station. 

EST-COS (CROP STAGE) 

ESTl-SOIL-MST (SURFACE MOISTURE) 

EST2-S0IL-MST (SUBSURFACE SOIL MOISTURE) 


NASA.JSC 
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